Spine) DOUBUBjayP] PUBLCLWUWWIOS 


Bus 2. SA ug 


iIcD 278 
zsoB 


COMMAND 
REFERENCE 
GUIDE 


Copyright 1983,  ZAX Corporation. All Rights Reserved 
Worldwide. This publication is protected by federal 
copyright law. No part may be copied or distributed, 
transmitted, transcribed, stored in a retrieval system, 
or translated into any human or computer language, in 
any form or by any means, electronic, mechanical, 
magnetic, manual, or otherwise, or disclosed to third 
parties, without written permission from ZAX Corporation. 


Prepared by 
ZAX Corporation 


2572 White Road, Irvine, California 92714 


Part No. 20-100-03, Rev. B Printed: December 1983 


INTRODUCTION 


The information contained in this COMMAND REFERENCE GUIDE 
relates to emulators directed at 2Z-80B based devices. 


The ICD-278 is capable of initiating 29 different 
software commands. Each command is structured in a 
particular format that must be selected and executed 
accurately. It is therefore important for the design 
engineer to become familiar with the proper command 
instruction and results in order to use the emulator 
commands effectively. 


For easy identification and immediate usage, symbolic 
notation will be used to explain the proper input format. 
This notation will be in the form of a console keyboard 
illustration, typical of the type an operator would be 
using. 


Each console keyboard element will symbolize the EXACT 
input operation which must be performed, including 
spacing, feature keys, optional characters, numbers, etc. 
The operator has only to determine which command format 
to use and then follow the format command configuration 
displayed for each command. 


Each command is defined by its symbolic key letter, the 
command name, an explanation and an example of typical 
command usage. 
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ADDRESS/DATA Parameters 


Throughout this guide, the majority of commands will 
require the user to input address or data information. 
This section describes the address/data parameters 
available and explains their usage. Also displayed are 
the various symbol notations and their explanation. 


The address/data common to the ICD commands is 
displayed to the right of the parameter 
explanations and characterized by the symbol: 


This parameter represents a hexadecimal 
1 PHYSICAL memory address in hex 16-bit. It can 
1 be specified by offset registers, addition or 
subtraction. In a "DON'T CARE" situation, "Xx" 
may be specified for the BREAK and EVENT 
commands (in this case, the parameter cannot 
be specified by the offset registers, addition 
or subtraction). 


This parameter represents a HEXADECIMAL 16-bit 
i memory address. 


, This parameter represents a BINARY 16-bit 
} physical memory address. It can be used ONLY 
| for a hardware break address in the BREAK and 
EVENT commands, and is displayed whenever 
using the BREAK status command. 


ASCII 32! 
| 


This parameter specifies data modification in 
ASCII codes. All ASCII A thru Z characters(32) 
may be used. 


This parameter specifies to use WORD or BYTE 
data (8/16-bit). The valid range is ¢ to F 
and "xX" (don't care). 


™ This parameter is used to specify the number 
of BYTES. The proper format for data entry is; 


"En" (number of bytes) 


NOTE: The letter "L" must be specified before 
the number can be entered. 


SYMBOL Notation 


This symbol is used to represent a keyboard 
character that the operator will utilize. 
NOTE: Consult your console keyboard 
operating manual for validation of characters. 


O This symbol displays to the operator that an 

address, data group, letter code, etc., is 
needed at this point in the command format. 
The options are always explained immediately 
after this symbol or in the address/data box. 


ze This symbol is used to represent a response 

from the system via the console display. The 
symbol will visualize all data exactly as it 
appears on the console screen. 


@,@ This symbol indicates additional information 
may be found in the APPENDIX section. 


@, @ This symbol locates various notes throughout 
the Command Reference Guide. 


EXAMPLE 


pao000000m) 


MoVE THE DATA THAT RESIDES IN 


IN THIS EXAMPLE, "M" 1S THE SYMBOL USED TO INITIATE A THE TARGET SYSTEM MEMORY 
MOVE COMMAND. SINCE THE LETTER "M" 1S USED TO SPECIFY G@ - OFFF, To THE EMULATOR 
THE MOVE COMMAND, THERE ARE NO OPTIONS AVAILABLE YET. MEMORY. START AT THE ICD 
ADDRESS, @; 
THIS SPECIFIES A DATA ENTRY THAT 1S REQUESTED. THE : 
AVAILABLE ADDRESSES WILL ALWAYS BE DISPLAYED JUST TO >M @, FFF,@,UP 


THE RIGHT OF THE COMMAND FORMAT EXPLANATION > > > > > 

THIS SPECIFIES A SECOND DATA ENTRY. IN THIS EXAMPLE, guppemmmnon 

THE MEMORY ADDRESS AT WHICH THE DATA TRANSFER 1S 
TERMINATED. THE AVAILABLE ADDRESSES TO THE USER ARE> > | ee 
THIS SPECIFIES A THIRD DATA ENTRY. IN THIS EXAMPLE, A 


BEGINNING MEMORY ADDRESS FOR THE DATA TRANSFER. THE 
AVAILABLE ADDRESS TO THE USER IS a ae ae Se ae? a ae zi 


THIS SPECIFIES THE OPTION OF USING EITHER UP oR PU TO 
DETERMINE HOW DATA 1S TO BE TRANSFERRED BETWEEN THE ICD 
AND THE TARGET SYSTEM. 


PRU ‘UP | < THE AVAILABLE OPTIONS FOR THE 
3 


KEYBOARD CHARACTERS WILL ALWAYS BE 
DISPLAYED TO THE LEFT OF THE 
EXPLANATION. 


68 08 0 O 


A AL B C CO D Di E EV F GH 1 ID LE M MA N O P PI PR Q R S SA SU T U V 


: EXAMPLE 


BOO 


IN LINE ASSEMBLER; 
(1) SPECIFIES THE MEMORY ADDRESS . 


>A 106 
BEEBE (2) CONSOLE DISPLAYS THE ICD abdpRESS Ate eyo aaa 


13 DE 
0104 LD DE,BAOdH 


SPECIFIES A MNEMONIC CODE TO BE USED IN THE Z80 107 EX DE,HL 


ASSEMBLER 


THe ASSEMBLE command IS USED FOR WRITING SOFTWARE PATCHES 


EMPLOYING THE INTERNAL 64K MEMORY OF THE ICD EMULATOR. 


WYal Bb c cop DE EF GHIW0OULM MAN OP PPRQRS SA SUT U V 


5900000008 


@ HARDWARE Break . 
Type 12 STANDARD HARDWARE BREAK; 


'O} B | eM SPECIFIES A HARDWARE BREAK NAME. 


(1F NONE 1S SPECIFIED, ASSUME A THEN B THEN C AFTER 
WHICH OCCURS THE ERROR MESSAGE; BREAK BUSY) 


(2) SPECIFIES THE BREAK STATUS: 


MEMORY ACCESS P| PORT wRITE 
OD Geo sex © B & cove sero: 


WR MemorY wRITE P| INTERRUPT ACKNOWLEDGE 


(3) SPECIFIES A BREAK ADDRESS 


SPECIFIES THE BREAK PASSING COUNT 
(pEcIMAL 1 TO 65535: DEFAULT=1) 


EXAMPLE @ 


sBo00G& 


@ HARDWARE Break 
Type 2 EveNT TRIGGER BREAK; 


OHA] 8) eM SPECIFIES A HARDWARE BREAK NAME 


(see Type 1: STANDARD HARDWARE BREAK) 


| (2) SPECIFIES AN ARM/INDIVIDUAL BREAK; 


oDoec 
oo 


THE ARM BREAK OCCURS ONLY AFTER THE EVENT 
TRIGGER TAKES PLACE 


THE INDiviDUAL BREAK TAKES PLACE WITHOUT 
REGARD TO THE EVENT TRIGGER 


THE BREAK COMMAND 1S USED TO SET THE STANDARD HARDWARE AND SOFTWARE 
BREAKPOINTS. SUPPLEMENTAL BREAKPOINT COMMANDS INCLUDE SETTING; AN 

EVENT TRIGGER BREAK, AN ETERNAL BREAK, AN OPERATIONAL BREAK AND 

DISPLAYING A BREAK CONDITION. SUPPLEMENTAL COMMANDS MAY BE USED IN 

CONJUNCTION WITH THE STANDARD HARDWARE AND SOFTWARE BREAK COMMANDS. 


A AL Bem C CO D DI E EV F GH! ID L M MA N O P PI PR Q R S SA SU T U V 


ee 


@ HARDWARE Break 
Type 3. EXTERNAL BREAK; 


OPT SPECIFIES AN OPTIONAL EXTERNAL BREAK 


G): SPECIFIES THE EXTERNAL BREAK TO OCCUR AT ay FL TO) 
: THE Hl} or LOW EDGE ’ 


508008 


& HARDWARE BREAK 
Type 4 BreaAK CONDITION: 


GQ): PB | RB SPECIFIES A HARDWARE BREAK NAME 
A (see Type 1: STANDARD HARDWARE BREAK) 
(2) MAKES A SPECIFIED BREAK! 

B00... 


ro a INVALID 
GB) cucaren 


@ NOTE: IF THE SPECIFIC HARDWARE BREAK NAME 1S OMITTED, 
ALL HARDWARE BREAKS ARE AFFECTED. 


fe] Jofetsfot:: 


@ SOFTWARE Break 
TyPeE 1 STANDARD SOFTWARE BREAK: 


Gi): ‘OR 7. SPECIFIES A SOFTWARE BREAK NAME 


(MUST SPECIFY) 


(2) sreciries A BREAK ADDRESS 


eQ SPECIFIES A BREAK PASSING COUNT 
(peEcIMAL 1 To 65535: DEFAULT=1) 


a>tetsT=To. 


BREAK 
Type 2. Enasie/DISABLE BREAK: 


G). 


2 
Gp sreciries TO PLACE SOFTWARE BREAK IN THE ENABLE STATE 


D | SPECIFIES TO PLACE SOFTWARE BREAK IN THE DISABLE STATE 
(NO SOFTWARE BREAK OCCURS) 


@ Note: WHEN THE SOFTWARE BREAK 1S IN THE ENABLE state, 
ExeEcUTE MOV A,A (7FH): AND A BREAK WILL OCCUR. 
BREAKS CAN BE SET USING AN ARBITRARY NUMBER BY 
GENERATING THEM IN THE USER PROGRAM, 


12 


Ee] Jofelc 


@ SOFTWARE Break 
Type 3 BREAK CONDITION; 


1 
G): ON 7 | SPECIFIES A SOFTWARE BREAK NAME 
se’ (MUST SPECIFY) 
(2): MAKES A SPECIFIED SOFTWARE BREAK: 
Oo 


oGe™: 
Bow 


@)NOTE: IF THE SPECIFIC SOFTWARE BREAK NAME 1S OMITTED, 
ALL SOFTWARE BREAKS ARE AFFECTED. 


>fe] Jofel: 


@ SUPPLEMENTAL Break 
TYPE 1 


Gi): SPECIFIES A WAIT Timeout 
SPECIFIES AN EVENT TRIGGER 
SPECIFIES A WRITE PROTECT 


(2) MAKES ANY OF THE (:) COMMANDS: 
BD" 
O) INVALID 


‘OF SPECIFIES AN EVENT TRIGGER BREAK 


SPECIFIES A BREAK PASSING COUNT 
() (DECIMAL 1 To 65535: DEFAULT=1) 


@ SUPPLEMENTAL Break 
Tyre 3 


C):@ CLEARS THE EVENT PASSING CONDITION BY RESETTING 
: THE CONDITION OF THE ARM OCCURRENCE 


14 


EXAMPLE: BREAK Command 


DISPLAY BREAK STATUS WITHOUT HARDWARE BREAK ON; 


DISPLAY A.BREAK STATUS WITH HARDWARE BREAK ON; 


>B OF , 180 


> 


B 
A (aw) OF 6100 1 0 IND (CAA 0001 p00 p00) 


S (DI) 
W (OFF) 


SET BREAK STATUS WITH A 16-BIT PHYSICAL ADDRESS AND ISSUE A BREAK STATUS COMMAND ; 
>B/A M, O60X_111X_XxXxx 6600 
A (ON) M XX@ 1 f IND (QOOX_111X_XXX 9000) 


EXAMPLE: BREAK Command 


SET A SOFTWARE BREAK USING A HEXADECIMAL ADDRESS; 
>B/7 1234 
A (ON) M XX@ 1 f IND (OA6X_111X_XXXx 6000) 


A (ON) M XX@ 1 ® ARM (OBOX_111X XK 6000) 


>B S=EN 

>B 

A (ON) M XX@ 1 QB ARM (OOOX_111X_XXXX_ 00H) 
7 (ON) 1234 

T (ON) 

S (EN) 

W (OFF) 


16 


EXAMPLE 


EBOBOSOGs 


EXECUTE MULTIPLE HANDLING OF 
(i) ~Q > () SEES ES THe Or EES NON Dil SUBTRACTION AND ADDITION USING 
HEX AND DECIMAL DATA 


NOTE: DECIMAL 1S VALID FOR ~-8388608 To +8388607 PN ERE 


HEXADECIMAL VALID FOR 0 to FFFFFF(H) -3C 123441234 
H: OAd9A4 
D: 2468 


>C 100@6H-FFFH 
Hl aaa 


: THE CALCULATION comMAND 1S USED TO ADD AND SUBTRACT HEXADECIMAL 
AND DECIMAL NUMBERS. THE OPERATION OF ADDITION AND SUBTRACTION 
ON DATA MAY BE PERFORMED TOGETHER ON THE SAME LINE. 


A AL B fem co D Di E EV F G Ht WW LM MA N O P PI PR Q R S SA SU T U V 


EXAMPLE 


>[cfofot stot sol sfol 


MEMORY COMPARISON OF THE 
(1) SPECIFIES THE COMPARISON START MEMORY ADDRESS RANGE: @ To (001 


re >CO Bs » 
(2) SPECIFIES THE END MEMORY ADDRESS 0 ,FFF ,0001,UP <cr> 
: 4 


1 2 
ce eeem ApprRess M ADRESS M 
(3) sreciries THE START MEMORY ADDRESS TO BE COMPARED one a ae iu 


(4) sreciries EITHER, 


P| TO USE G) FOR THE USER MEMORY, AND (3) 


FOR THE ICD PROGRAM MEMORY, 


@ NOTE: 
(1) FOR T 
Co... 5... | - TARGET SYS MEMORY ADDRESS 
(s) 2 - TARGET SYS MEMORY CONTENTS 
3 - EMULATOR MEMORY ADDRESS 
4 - EMULATOR MEMORY CONTENTS 


@ NOTE: UP 1S USED TO COMPARE TARGET SYSTEM MEMORY 
CONTENTS TO EMULATOR MEMORY CONTENTS. 


PU 1S USED TO COMPARE EMULATOR MEMORY CONTENTS 
TO TARGET SYSTEM MEMORY CONTENTS. 


Cc THE COMPARE COMMAND 1S USED TO COMPARE THE CONTENTS OF 
SPECIFIED MEMORIES AND THEN DISPLAY THE UNMATCHING DATA. 


A AL B Cf¥eh D Di E EV F GHJI IDL M MA NOP PL PR QRS SA SUT U V 


EXAMPLE 


DUMP MEMORY CONTENTS FROM @ To 30; 


>D 0,36 


$g00 21 FF gO 1 
010 61 06 OO OD ......... 
$026 2 OD @ 


DUMP MEMORY CONTENTS INTO WORD; 
>D/W er es : 
NOOO FO7F A18F F805 S@OF FID 


i 
12 


AD10 FOI7 ESAF FOS 240F FOS BDAF 


AO36 FOOD A125 FOOS OOOF F30F — 


8 9 
13: 23 


A 


CD: Be UE 


B7 C2 #6 00 C3 


/..P...RO'%P 


.P - 
.P%!.P...5/"EP.R 


ASCI | CODE 
1. ..4.w. .#7B..C. 


EXAMPLE -@ 
>Toy Jojo sfol: 


G): SPECIFIES TO DUMP DATA INTO WORD UNITS 
' (iF OMITTED, DATA 1S DUMPED IN BYTE UNITS) 


(2) srecir ies THE DISPLAY STARTING MEMORY ADDRESS 
(3) SPECIFIES THE DISPLAY ENDING MEMORY ADDRESS 


THE DUMP COMMAND IS USED TO DISPLAY THE MEMORY CONTENTS IN 
EITHER BYTE or WORD UNITS. THE CONTENTS IS REPRESENTED BY A 
HEXADECIMAL NUMBER AND ASCI| CODE. 


A AL B C CO Bea DI E EV F GH! IDL M MA N O P PIL PR Q R S SA SU T U V 


EXAMPLE 
Fooooow 


SPECIFIES THE STARTING MEMORY ADDRESS | >DI 100 
©) (iF OMITTED, DATA IS DISPLAYED FROM THE CURRENT PC) 0100 210080 LD HL, BOOH 
$103 110040 LD DE, AAAAH 
$106 7E LD A, (HL) 


(2) SPECIFIES THE ENDING MEMORY ADDRESS 0107 B7 OR A 
Seth, ) $108 C20003 JP NZ,0300H 
$10B 12 


LD (DE),A 
H10C 23 INC HL 


010D 13 INC DE 

P1iME C30661 JP 106H 
>DI 100,114 

$106 210086 LD H_,ABO00H 
$103 110046 LD DE, GABAGH 
0106 7E LD A,CHL) 


0107 B7 OR A 
$108 C20003 JP NZ,0300H 
6108 12 


LD (DE),A 
$1GC 23 INC HL 
1 
@ NOTE: >DI <crR> , DISPLAYS 12 LINES OF CODE. 111 0d 


NOP 
H112 3A003A LD A,(3A00H) 
@ NOTE: IF () AND '@. ARE OMITTED, THE DATA 
DISPLAYED WILL BE THE CURRENT PROGRAM COUNTER. 


THE DISASSEMBLE commMAND IS USED TO DISASSEMBLE THE MEMORY 
CONTENTS AND DISPLAY THE RESULT. 


A AL B C CO D@UBE EV F GH tI IDL M MA 'N O P PL PR QR S SA SU TU V 


EXAMPLE 


@Y-T-lolel-lol- ML bole: 


TYPE 1 EXAMINE anb CHANGE MEMORY CONTENTS 


TYPF 2 EXAMINE MeMoRY CONTENTS ONLY EXAMINE AND CHANGE MEMORY IN 


WorD DATA; 


>E/W 100 <cr> 


0108 200E 


4 
SPECIFIES THE MEMORY CONVERSION DATA/CONVERSION 
HEX 
STARTING MEMORY ADDRESS pata | (ASO! % eeenttere 


EXAMINE AND CHANGE MEMORY IN 


; SPECIFIES TO CHANGE THE MEMORY CONTENTS ON A WORD BASIS - CHANCE 
G) ‘3B LW (DEFAULT 1S A BYTE Basis) F tae raha i : Bees? 
ia 0104 11FD = 
(2) SPECIFIES BEGINNING ADDRESS OF MEMORY TO BE FILLED (PHY 16 0106 FDAB = 


@ NOTE: MuLTI-DISPLAY OF DATA 1S POSSIBLE USING THE 


FORMAT LISTED BELOW: BYTE DATA; 
>E 0100 <cR> 
Cc | 

a DISPLAYS DATA. AT THE NEXT ADDRESS AFTER CHANGE 0100 FA - CHANGE DATA <cr> 
GD Ged 2 shes 04Ta art THE same ADDRESS AFTER CHANGE ae os : 
Pe PYM DISPLAYS DATA AT THE ADDRESS THAT 1S DECREMENTED oi = 
HA @ ey 1 AFTER THE CHANGE . 
0105 11 = 
GD texminates THE EXAMINE COMMAND AFTER THE CHANGE tae ae i 


@ NOTE: THE speciriep ASCII or HEX DATA IS WRITTEN TO 
THE SPECIFIED ADDRESS BUT NOT VERIFIED 


THE EXAMINE COMMAND 1S USED TO CHANGE THE MEMORY CONTENTS TO EITHER NOTE: (3) 
= ASCI1 OR HEXADECIMAL DATA. Two TYPES OF EXAMINE COMMANDS ARE 4 ; e IS OMITTED, 
AVAILABLE TO THE USERS (1)EXAMINE AND CHANGE MEMORY CONTENTS, THE MEMORY CONTENTS ARE NOT 
(2)EXAMINE THE MEMORY CONTENTS ONLY. CONVERTED. 


A AL B C CO D DI MS EV F GH I ID L M MA N O P PIL PR QR S SA SU T U V 


-fet vjofejolol c- 


@ StanoarD EVENT TRIGGER 
Type 1; 


‘OW s | EB sreciries AN EVENT TRIGGER STATUS BY NAME; 


NW MEMORY ACCESS 


G MEMORY READ 


ee INTERRUPT ACKNOWLEDGE 
EQ commno EXECUTION 


1 


‘oO Gy FECIFIES TO DIRECT AN EVENT TRIGGER AT A PARTICULAR | 
@): BREAK ADDRESS = 
6) (=) — sPeciFies event DATA (BYTE pata) D 


(4) IF BYTE DATA 1S USED, SPECIFIES THE DATA [ane ) Ga) 
eur 


-— 


a 


EXAMPLE @& 


G1) SPECIFIES TO: 


0 | MAKE AN EVENT TRIGGER ENABLED 


fo FU AN EVENT TRIGGER DISABLED 
2 
GED cuca AN EVENT TRIGGER 


@ NOTE: "X" may BE SPECIFIED AS "DON'T CARE" FOR BINARY 
OR HEXADECIMAL INPUT (1 oR 4 BIT) 

@ NOTE: IF A STATUS 1S SPECIFIED FOR PORT OPERATION, THE 
HIGH-ORDER 8 BITS OF THE ADDRESS SHOULD BE "X". 
NOTE: IF A NEW SETTING 1S MADE AFTER AN EVENT CLEAR, 
THE EVENT GOES TO THE ON STATE. 
NOTE: A NEW EVENT CONDITION HAS PRECEDENCE OVER A PRE-SET 
EVENT CONDITION, BUT ONLY AT THAT PARTICULAR SETTING. 


THE EVENT COMMAND 1S USED TO SET OR RELEASE AN EVENT TRIGGER. THE 
STANDARD EVENT TRIGGER 1S SPECIFIED BY A STATUS NAME, ADDRESS AND 
EVENT DATA. IT 1S ALSO POSSIBLE TO OUTPUT AN EVENT TRIGGER PULSE VIA 
THE EVENT TRIGGER CONNECTOR DURING A SPECIFIED MACHINE CYCLE(TYPE 2) 


AN EVENT TRIGGER CAN ALSO BE USED AS A HARDWARE BREAK, 


A AL B C CO D DI E F GH ts Ib tM MA N OP Pi PR Q R S SA SU TU V 


| EXAMPLE: EVENT Command | 


SpecIFY AN EVENT HEX ADDRESS USING "DON'T CARE‘; 


iS =O 
ADDRESS = AXXO (1D10_00% 9000) 
= XX OOKK_ XXX) 


SPECIFY EVENT DATA; 


>EV D=0010_11XX 


>EV 

(ON) 

STATUS = OF 

Appress = AXXO (101. XXXX 200 i) 
DATA == 2X (0010_11XX 


SET EVENT COMMAND USING ADDRESS, DATA AND STATUS, 


>EV A=QOFF D=12 ST=MR 


>EV 

(ON) 

Status = MR 

Aporess = OOFF (000 $000 _1111_1111) 
DATA =-*12 (0001_907). 


EXAMPLE 


se0o0Oo00008) 
C): 8 & 


SPECIFIES THE BEGINNING ADDRESS OF THE MEMORY TO 
BE FILLED a 


FILL MEMORY wITH "@" FROM 
SPECIFIES TO FILL MEMORY ON A WORD BASIS ADDRESS 0000 To QOFF: 
(DEFAULT 1S A BYTE Basis) 


>F 000, 00FF 0 


FIL MEMORY WITH ASCII 


CHARACTER FROM @ To FF: 
SPECIFIES THE ENDING ADDRESS OF MEMORY TO et (eer) (Eee) 
16 . : 
FILLED (1F OMITTED, DATA TO BE FILLED FROM THE a ae F 000, OFF, 'ZAX 


BEGINNING MEMORY ADDRESS 1S WRITTEN) 


SPECIFIES DATA TO BE FILLED WITHIN THE BEGINNING 
AND ENDING ADDRESSES ees 


F THE FILL COMMAND IS USED TO FILL MEMORY WITH SPECIFIED DATA, 
EITHER HEXADECIMAL OR ASCII! CODES. 


A AL B C CO D Di E EVE GH ! ID L M MA N O P PI PR Q R S SA _ SU 


EXAMPLE 


EXECUTE A USER PROGRAM STARTING AT OH; 

>G 0,B 

PC MM OP SPP AF BC DE He IX WW {  IFCSP) 
$008 110086 LD DE,@BOO00H FFFC 0000 0000 BADD ADAH AACA OCOD BO 6 h40d 


<BREAK HARDWARE A> 3 


CONTINUE THE EXECUTION AFTER BREAK; 

>G 

PC MC OP SP AF BC DE HL 1X lY | IFCSP) 
15DC 3A003A LD A,(3AQQH)  FFB6 3A00 1410 BOd1 9FO1 Ohdd BOC BO O 0300 


<BREAK MONI TOR> 


EXAMPLE -@ 


-Tclop>fotsfol cr 


SPECIFIES THE PROGRAM EXECUTION STARTING MEMORY ("=== 
ADDRESS (IF OMITTED, THE PROGRAM EXECUTION IS 


CONTINUED FROM THE CURRENT PC) 


SPECIFIES THE PROGRAM EXECUTION ENDING MEMORY 
ADDRESS are 


SPECIFIES A SECOND (OPTIONAL) ENDING MEMORY 
ADDRESS THAT MAY BE USED IN CONJUNCTION WITH THE 
FIRST ENDING MEMORY ADDRESS 


@ NOTE: WHen (1) AND (2) ARE OMITTED, A BREAK 1S 
NOT SPECIFIED. 


or: & 
THE GO COMMAND 1S USED TO EXECUTE THE USER PROGRAM. e G J 


ALLOWS SUCCESSIVE EXECUTION OF 
USER PROGRAM ONCE A BREAK HAS 


OCCURRED 


A AL B C CO D DI E EV F fem H | ID L M MA N O P PI PR Q R S SA SU TU V 


© Type @ REAL TIME TRACE STATUS e Type @ REAL TIME TRACE COUNTER RESET 


boooe a & 


@® TYPE (3) MONITOR TRIGGER | @ TYPE 4) EVENT TRIGGER 
sooo Gs soOoooOG& 
TYPE & © TypE@ FORMAT DISPLAY @® TYPE 6) HISTORY SEARCH 


" -[ Jo} Jo} sfol <- pEoGooOo000G& 


(i): BS M SPECIFIES THE BEGIN MONITOR TRIGGER. IN THIS MODE, TRACE SECTION 
© ; iS INITIATED BY THE EMULATION START AND TERMINATED AT A 
PREDETERMINED BREAK POINT SPECIFIED BY THE RANGE; 


rE | M SPECIFIES THE END MONITOR TRIGGER. EMULATION IS INITIATED USING 

7 THE GO or NEXT COMMAND TO START TRACE. THE MONITOR WILL RESPOND 
WITH A BREAK WHEN THE TRACE 1S TERMINATED. THE TRACE RANGE UP TO 
WHERE THE BREAKPOINT OCCURS IS A MAXIMUM OF 2048, 


3) (2) SPECIFIES THE TRACE RANGE(DECIMAL 1 To 2047) 


ry Ci): B E SPECIFIES THE BEGIN EVENT TRIGGER. IN THIS MODE, TRACE BEGINS 
+] 


WHEN AN EVENT POINT IS PASSED AFTER EMULATION HAS BEGUN. 


E SPECIFIES THE CENTER EVENT TRIGGER. IN THIS MODE, THE TRACE 
= SECTION 1S RECOGNIZED BOTH BEFORE AND AFTER THE EVENT POINT. 


SPECIFIES THE MULTIPLE EVENT mode. IN THIS MODE, A TRACE 1S 
PERFORMED EACH TIME AN EVENT POINT 14S PASSED DURING LOOP 
PROCESSING. 


(MIE 


SPECIFIES THE END EVENT TRIGGER. IN THIS MODE, EMULATION 1S 
INITIATED USING THE GO OR NEXT COMMAND TO START THE TRACE. WHEN 
THE EVENT POINT 1S PASSED, THE TRACE TERMINATES. 


@ @) SPECIFIES THE TRACE RANGE(DECIMAL 1 TO 2047). WHEN (2) 1S OMITTED IN THE 
SPECIFICATION OF BE,BM & CE, THE DEFAULT 1S 2047 AND 1023 WHEN oOmiTTED FOR ME. 


@ (i): SPECIFIES THE DISPLAY IN MACHINE CYCLE FORMAT 


Sp SPECIFIES THE DISPLAY IN MACHINE CYCLE AND DISASSEMBLE 
(EXCEPT FOR OPERATION CODE FETCH) 


ee @ SPECIFIES THE DISPLAY OR SEARCH INITIATION STORAGE POINTER 
(DECIMAL 1 To 2047) 


® © ©) SPECIFIES THE DISPLAY OR SEARCH TERMINATION STORAGE POINTER 
(DECIMAL 1 To 2047) 


6] SPECIFIES TO SEARCH FOR THE REALTIME TRACE CONTENTS 


6 @): 
7 
SPECIFIES THE SEARCH DATA — HEX 


SPECIFIES A STATUS TO BE SEARCHED FOR 


SPECIFIES SEARCH STATUS BY NAME, 


iM | FR | MEMORY READ CYCLE ra INTERRUPT ACKNOWLEDGE CYCLE 
GD GD vevow waite cvcce YG overation cove retcn 
oS FR | PORT READ CYCLE FP PORT WRITE CYCLE HALT ACKNOWLEDGE CYCLE 


THE HISTORY COMMAND 1S USED TO SET A TRIGGER MODE FOR REALTIME 

TRACING, AND TO DISPLAY OR SEARCH FOR THE USER PROGRAM OPERATION TO @ See APPENDIX A 
BE TRACED. THERE ARE SIX DIFFERENT HISTORY COMMANDS AVAILABLE TO THE 

USER; REAL Time TRAcE Status, REAL Time TRACE COUNTER RESET, MONITOR X AMPLE 
TRIGGER, EVENT TRIGGER, FormaT DISPLAY AND HISTORY SEARCH. we 
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EXAMPLE: HISTORY Command 


DISPLAY THE HISTORY STATUS; 


>H 

CLock CounTER = GOCAQOAA/ 
STORAGE ModE = EM 
STORAGE StzZeE = 14/ 14 


DISPLAY THE REAL TIME TRACE IN MACHINE CYCLE; 


>HM, 26 
INT ADDR DT ST 
$626 003 11. M1 
104 06 MR 


0009  OOPA MR 
0008 O00. 11. M1 
0007 Pac 00 MR 
0006 00D MR 

5 — OOPE 7E MI 


| EXAMPLE: HISTORY Command | 


DISPLAY THE REALTIME TRACE IN MACHINE CYCLE AND DISASSEMBLE CODE; 


>H D 

POINT ADDR DT ST OP 

$623 pp0o 210003 LD HL,0300H 
20 1003 110004 LD DE,A400H 
0617 1006 E5 PUSH HL 

$016 6685 3 MN 

0015 $84 yf) Mw 

0014 O07 D5 LD HL, @AZO0H 
0613 0083 4 Mw 

0012 0082 4) Mw 

0011 oépds 2 1D0A0 LD HL, @AGQOH 
1608 A008 110680 LD DE,0BO00H 
1005 QOOE 7E LD A, CHL) 
004 Added 3A MR 

$003  O¢aF 77 LD (HL).A 
$2 Added 3A Mw 


SEARCH FOR THE CONTENTS OF REAL TIME TRACE FOR A MEMORY READ; 


>H_ S,///MR 

Point T Apor DIST 

0613 0101 0D MR 
12 102 AO MR 

010 104 00 MR 
") $105 BO MR 

D007 AOOO FF MR 


@ NOTE: THE REAL TIME COUNTER COUNTS THE CPU STATE NUMBER (CPU CLOCK) IN 32 BITS. 
@ NOTE: THE POINTER AT WHICH A PROGRAM IS INITIATED wiTH A Go or NEXT COMMAND 
AND THE POINT AT WHICH THE PROGRAM WAS PREVIOUSLY STARTED, ARE 
DISPLAYED AS THE REAL TIME TRACE STARTING STORAGE POINTERS. 
IF THESE POINTERS EXCEED 2047, A FULL MESSAGE IS DISPLAYED. 


EXAMPLE 


SPECIFY THE PARTIAL AND SYSTEM 
ee EITHER THE SYSTEM, PARTIAL, or ALL INCIRCUIT INCIRCUIT MODES! 
9 
>! 1 
>| 
0] THE SYSTEM MODE ENABLES DEBUGGING (SOFTWARE In-ciRcUIT Mope 1 
ONLY) USING THE ICD PROGRAM MEMORY. IN. THIS 
MODE THE TARGET SYSTEM I/O AND _ INTERRUPT 19 
SIGNALS ARE IGNORED 5 | 
N-CIRCUIT Move 6 
THE PARTIAL iINCIRCUIT MODE ENABLES DEBUGGING | 


USING THE ICD PROGRAM AND TARGET SYSTEM 
MEMORIES. THE SPECIFIED MAPPING BECOMES VALID AS 
DO THE SYSTEM |/O INTERRUPT SIGNALS 


THe ALL INCIRCUIT MODE ENABLES DEBUGGING USING 
ONLY THE TARGET SYSTEM MEMORY. MEMORIES 
SPECIFIED AS READ/WRITE ano READ ONLY (R/W,RO) 
ARE OPERATED BY THE’ USER MEMORY (US) 


© NOTE: WHEN NO PARAMETER IS SPECIFIED, THE CURRENT STATE 
1S DISPLAYED 


Ls THe INCIRCUIT commMaND 1S USED TO SET THE ICD MAPPING MODE. @ See APPENDIX B 
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EXAMPLE 


>ID 
ICD-278 For Z80 V1.0 


ee D THe IDENTIFICATION COMMAND 1S USED TO DISPLAY AN ICD DEVICE NAME AND 


A VERSION OF THE INSTALLED FIRMWARE. 
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EXAMPLE 


p508000000G 


(1) srecirics EITHER THE; LoaD THE TEST HEX FILE ON 
DISKETTE: 
TERMINAL Port (IGNORE SOFTWARE HANDSHAKE ) 
FP TERMINAL Port (PERFORM SOF TWARE HANDSHAKE ) a TEST 
AUXILIARY PorT (IGNORE SOFTWARE HANDSHAKE) 
7 >L/T ,100 
HOST Port (PERFORM SOFTWARE HANDSHAKE) 200 


(2) sreciries THE NAME OF THE FILE TO BE LoapeD! 


SPECIFIES THE BIAS OF THE OBJECT TO BE LOADED 
CiF OMITTED, THE OBJECT STARTING ADDRESS 1S SPECIFIED) 


(4) srecir ies THE LOAD MESSAGE HEX 


@ NOTE: THis PARAMETER 1S VALID ONLY WHEN THE UTILITY 
SOF TWARE PROGRAM ZICE 1S AVAILABLE. 


| THE LOAD COMMAND 1S USED TO LOAD EITHER A HEX FILE ON A DISKETTE OR 
THE OBJECT PROGRAM (INTEL FORMAT) FROM EITHER SPECIFIED PORT IN © See APPENDIX D 
MEMORY . 


A AL B C CO D Di E EV F GH I ID GBM MA N O P Pl PR Q R S SA SU T U V 


EXAMPLE 


>[uJol> Tot stots for] c 


Move MemMoRY oF @H THROUGH 
FFFH; 


>M O,FFF,@,UP 


SPECIFIES THE MEMORY ADDRESS AT WHICH THE DATA TRANSFER 
IS INITIATED 


(2) SPECIFIES THE MEMORY ADDRESS AT WHICH THE DATA TRANSFER § PHY 16 
IS TERMINATED eee 


SPECIFIES THE BEGINNING MEMORY ADDRESS 
TO WHICH THE DATA TRANSFER IS MADE 


| @ S SPECIFIES TO MOVE DATA FROM THE THE TARGET 
: U MEMORY TO THE ICD PROGRAM MEMORY 


P| U SPECIFIES TO MOVE DATA FROM’ THE ICD 
PROGRAM MEMORY TO THE TARGET SYSTEM MEMORY 


@ NOTE: When IS OMITTED, DATA 1S 


MOVED ACCORDING TO THE SPECIFICATION OF 
THE MEMORY MAP. 


THE MOVE COMMAND IS USED TO MOVE MEMORY BETWEEN THE ICD AND THE 
TARGET SYSTEM, 
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EXAMPLE 


Boo000e0a) 


(1) seeciries THE BEGINNING ADDRESS TO DESIGNATE MAPPING Speciry @ To FFF AS THE USER 


| — 1 aa MEMORY: 
(2) SPECIFIES THE MAP ENDING ADDRESS 


>MA @,FFF = US 
(3) SPECIFIES THE PROGRAM MEMORY, EITHER} 7 
PR s | DISPLAY THE STATUS OF THE 
0 | EAD ONLY MEMORY MAP! 

PR READ/WR ITE >MA 

2 - bE 1 (US=RW 
EN | 0 | THE AREA IN WHICH NO MEMORY EXISTS tb EE te ( ) 
ISTHE TARGET SYSTEM MEMORY IOBB-FFEF = RWW 


DISPLAY THE STATUS OF ~~ THE 
MEMORY MAP WHEN THE INCIRCUIT 
MODE 1S NOT 1; 


>MA 
© NOTE: WHen (2) IS OMITTED, 1K BYTES ARE SPECIFIED ieee ie O AUS-RW) 
@ NOTE: A BREAK OCCURS IN THIS AREA IF ACCESSED BY A PROGRAM \OOD-FFFF = Rw 


@ NOTE: IF No PARAMETER 1S SPECIFIED, THE CURRENT MAPPING 
CONDITION 1S DISPLAYED. 


THE MAP comMMAND IS USED TO SET THE ICD MEMORY MAP. THE TARGET SYSTEM e SEE INCIRCUIT C 
OR ICD PROGRAM MEMORY 1S USED ON A 1K-BYTE BASIS AND MUST BE Ee OnE NS 
SPECIFIED, 


MA 
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EXAMPLE | 


PERFORM A SINGLE STEP TRACE, FIVE STEPS FROM THE CURRENT PC; 


>N 5 

MC OP HL IX lY | IF (SP) 
10 3A00AD ~=—siédLDSsé*A, (OAC OOH) x asic Aspe 30 4312 0000 0000 06 6 APIA 
0103 77 LD (HL),A os esas bine, swede ee eee. ee kate 
0104 FEQS CP 5 Fore 0542 Sule. “eden ste. cued. cebu. Sa wi dees 
0106 C20001 JP NZ,@100H ee we. ese “urate: Shenk eanbadt, deaiatins cece ogee 
0109 2100AB LD HL PADOOH ww, eee eee eee AOD eee eee we tee 
PERFORM A SINGLE STEP TRACE FOR FIVE STEPS CHANGING PC; 
>R PC, 200 
>N 5 

OP 3g AF BC DE HL IX lY | IFCSP) 

to 303 a A, (3AQ0H) @O02E 3A42 ASCE 0301 ABCD A060 0000 06 6 OOd0 
0204 3A003A LD A,(ZAOH) oes cece cece eee cece eee ED TD OES 
0208 3A003A LD A,(3AG0H) ew. tien. sien Ge «teak. ands. See oft ene 


@ NOTE: THE STARTING ADDRESS CAN BE CHANGED BY CHANGING PC WITH A REGISTER COMMAND. 


| EXAMPLE -@& 
© 


SPECIFIES THE NUMBER OF SINGLE STEPS 
(A to 15535; IF OMITTED, 1 1S ASSUMED) 


N STEPS FROM THE CURRENT POINTER. 


iN} THE NEXT COMMAND 1S USED TO DISPLAY ALL TRACE DATA BY 
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EXAMPLE 
|| sEOBOBOw 


>O 
86 = 0000 
C:) SPECIFIES ONE OF FOUR OFFSET REGISTERS, EITHER, R1 Zz AgHd 
22 = OAD 
0o,0,8 ,8 83 = 0000 
. oe 50 83-A00D 
SPECIFIES THE OFFSET REGISTER SET VALUE SO 
26 = OA0d 
81 = 0000 
82 = DAD 
£3 = ADO 


@ NOTE: IF NO PARAMETER |S SPECIFIED, THE CURRENT SET 
VALUE IS DISPLAYED. 


THE OFFSET COMMAND IS USED TO SET A VALUE IN AN OFFSET REGISTER FOR 
RELATIVE ADDRESSING. ALL OF THE OFFSET REGISTERS CAN BE USED FOR THE 
ICD MEMORY ADDRESSING PARAMETERS. 
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obo OBOw efoogw 


@ TYPE 1 
@ lyre 2 


EXAMINE AND CHANGE PORT CONTENTS 
EXAMINE ONLY 


SPECIFIES THE BEGINNING . ADDRESS OF THE PORT TO BE {™— 
CHANGED (THE ASCI| or HEX DATA 1S WRITTEN TO THE QPHY 16 


SPECIFIED ADDRESS) 


(2) seeciries DATA TO CHANGE THE PORT 


@ NOTE: Mutti-pIsPLAY OF DATA 1S POSSIBLE USING THE 
VARIOUS FORMATS BELOW; 


CR BIRSNE DATA AT THE NEXT PORT AFTER CHANGE 


oO DISPLAYS DATA AT THE SAME PORT AFTER CHANGE 


DISPLAYS DATA AT PRECEDING PORT AFTER CHANGE 


GB estes THE PORT COMMAND AFTER CHANGE 


THE PORT COMMAND 1S USED TO CHANGE THE PORT CONTENTS WITH ASCII DATA 
OR HEXADECIMAL NUMBERS. TwO TYPES OF PORT COMMANDS EXIST; ONE 
EXAMINES AND CHANGES THE PORT CONTENTS AND THE OTHER EXAMINES THE 
PORT CONTENTS ONLY. 


EXAMPLE 


EXAMINE AND WRITE OUT A PORT} 


>P FF=12 12 34 56 78 


READ AND CHANGE PORT IN BYTES 
USING MULTI-DISPLAY FORMAT; 


>P 55 

oo mes sa 
56 56:23 
5 515° Be 
58 58:'D', 
58 58:00. 
59 59:12 
58 58:/ 


READ AND CHANGE PORT IN WORDS 
USING MULTI-DISPLAY FORMAT; 


>P 23 

23 23:00 
24 24:12 
25 25:33 
26 26:/ 
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EXAMPLE 


po806e0a 


(i) srecir ies EITHER, DispLay PIN STATUS; 


>P | 
B R | Gas REQUEST IN-CIRCUIT MODE | 


GD Non askacre ue : tEN) - 


“=: 4 nas aa ae 2 f a ae ayer = 
sam -| NTERRUPT ae ve [Nf = LL. INTR CEN) = 0 
; — oe ie cy ae DISABLE BUSREQUEST AND DISPLAY 
(2) SPECIFIES EITHER; re cS) re THE STATUS; 
>P| BUSRQ = DI 
TO PLACE THE INTERRUPT OR BUS STATE REQUEST >P| 
NMI EN) = 
DD TO PLACE THE INTERRUPT OR BUS STATE REQUEST BusRQ (DI) 
SIGNAL IN THE DISABLE STATE INTR (EN) = @ 


@ NOTE: IF No PARAMETER 1S SPECIFIED, THE CURRENT BUSRQ, 
NMI AND INTR CONDITIONS ARE DISPLAYED AS MASKED. 


/P i THE PIN COMMAND 1S USED TO MASK OR UNMASK THE TARGET SYSTEM @ See INCIRCUIT COMMAND 
INTERRUPTION SIGNAL WHEN THE INCIRCUIT MODE 1S 1. WHEN THE INCIRCUIT | 
MODE 1S 0, ALL THE INTERRUPTIONS OF THE TARGET SYSTEM ARE IGNORED 
AND ARE VALID WHEN THE INCIRCUIT MODE 1S 2, 
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EXAMPLE 
BEooO 


TURN PRINT ON AND OFF$ | 
(1) sreciries EITHER TO: 


>PR ON 


> 
ro, OUTPUT THE CHARACTERS SENT FROM THE ICD To Se 
BOTH TERMINAL ano HOST/AUX ports SPR OFF 


O | Boru DATA TO THE CONSOLE ONLY 


THE PRINT COMMAND IS USED TO OUTPUT CHARACTERS SENT FROM THE ICD To 
R THE TERMINAL and HOST/AUX PoRTS OR THE CONSOLE. 
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EXAMPLE 


Hogs 


ENABLE THE QUIT COMMAND; 


>Q 


THE QUIT COMMAND 1S USED TO RETURN CONTROL BACK TO THE HOST COMPUTER 
SYSTEM. THIS COMMAND 1S VALID ONLY WHEN THE UTILITY SOFTWARE 
PROGRAM, ZICE 1S AVAILABLE. WHEN OPERATIONAL, THE "@4" CODE 1S 
TRANSMITTED TO THE Host ComPUuTER SYSTEM. 
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| EXAMPLE | 


DISPLAY REGISTER WITH TITLES; 


>R 

PC SP SZHPNC A BC DE HL 1X LY A‘F' B'C' D'E' H'L' | IF (CSP)CHL) 
(00d 0000 000000 26 0000 A000 0000 0000 0000 O00 O00 0000 OOOO CO 6 6021 21 
CHANGE HL To a vALUE OF AQQO; 

>R HL=A000 

>R 


pc SPSCSZHPNGT,—COAsCiwBOC«iEC‘i R‘“CSSCSXSCOSLY_—sAIF ' OE HTL’ fF (SP)(HL) 
0606 2006 600000 20 OAAD OC00 CO0O OOOO OOOO COCO OOOO COCO 66D 6 CGC 21 2A 


TER] cr MECN DR Pecser] cr MGM ER POL=[o] cr 


@IYPE 1 REGISTER STATUS (CURRENT REGISTER CONTENTS) 
@ TYPE 2 REGISTER RESET (CiniTiALizes REGISTER To @) 
@ TYPE 3 REGISTER CHANGE (sPeciFIED CHANGE BELOW) 


(i) SPECIFIES ANY OF THE REGISTERS; 
A, F, B, C, D, E, H, L, | 
Ree 2B eS oD ek go ee eg 
BC, DH, HL, IX, IY, SP 
BC’, DE’, HL' 
CY, S, Z, HC, P, N, IFCIFF1) 


(2)srecir ies THE REGISTER CHANGE DATA fer 


@ NOTE: WHEN NO PARAMETER 1S SPECIFIED, THE CURRENT 
CONTENTS OF ALL THE REGISTERS ARE DISPLAYED. 


PROGRAM COUNTER. JHERE ARE THREE TYPES OF REGISTER COMMANDS 


R THE REGISTER command 1{S USED TO CHANGE THE Z8Q@ CPU REGISTER AND 
AVAILABLE; DISPLAY, RESET AND CHANGE. 


EXAMPLE -@ 


PR Q 


R 


S SA SU T U V 
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EXAMPLE 


>[sJoT>folsfoksfolc 


S 0,130, 12 
CG): fy PD SPECIFIES TO SEARCH FOR UNMATCHED DATA a : 


(DEFAULT: SEARCH 1S MADE FOR MATCHED pata) 


= >S/W 100, 118, 1234 
(2) sreciries THE MEMORY ADDRESS TO INITIATE A SEARCH 


>S/D 9, 10,00 
(B)sreciries THE MEMORY ADDRESS TO TERMINATE A SEARCH ano 
= ph2 
) 0003 
J seeciries THe search DATA HEX ae 


S THE SEARCH COMMAND 1S USED TO SEARCH FOR THE MEMORY CONTENTS AND 
DISPLAY THE SPECIFIED MATCHED OR UNMATCHED ADDRESS. 
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EXAMPLE 


>Tsk +] Jofo} >of: To}: fotsfol « 


(1) SPECIFIES WHICH PORT TO CONSIDER, EITHER THE; GENERATE THE TEST.HEX FILE ON 
DISKETTE; 
TERMINAL PorT (IGNORE SOFTWARE HANDSHAKE ) 
P| TERMINAL Port (PERFORM SOFTWARE HANDSHAKE) >SA TEST,O, 37FF.O 


CY avxiviary PORT (IGNORE SOFTWARE HANDSHAKE) 


HOST PoRT (PERFORM SOFTWARE HANDSHAKE) 


(2) sreciries THE NAME OF THE FILE TO CREATE 


(3) SPECIFIES MEMORY ADDRESS TO INITIATE OBJECT CREATION 
SPECIFIES MEMORY ADDRESS TO TERMINATE OBJECT CREATION 


(5) SPECIFIES THE START ADDRESS OF THE USER PROGRAM =" === 
is 
(6) SPECIFIES THE SAVE MESSAGE ASCII 32 Hex me NC 


@ NOTE: THis PARAMETER 1S VALID ONLY WHEN THE UTILITY 
SOFTWARE PROGRAM, ZICE 1S AVAILABLE. 


Ss A THE SAVE COMMAND IS USED TO CREATE A USER PROGRAM ON A DISKETTE AS 
tae tHE HEX FILE OR DUMP THE USER PROGRAM TO A SPECIFIED PORT USING THE @ See APPENDIX D 
~ INTEL FORMAT. 
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| EXAMPLE | 


CHECK THE TERMINAL PORT INPUT STATE; 


>DI 9000, 900C 
9 1E01 


00D 10 LD €£,1 

90602 60 NOP 

9003 B7 OR A 

9004 CAd296 JP Z,9002H 

9607 77 LD (HL),A 

9008 4 INC B 

9909 FEO@D CP @DH 

9608 C8 RET Z 

9f0C 77 LD (HL),A 

>Su/7 ON 

>B/7 9662 

>G 9606, 9008 

PC MC OP SP AF BC DE H IX WW | IFCSP) 
9408 64 INCB @@2E FFO8 1CZE 6301 ADCO 0000 C000 6 6 Oded 


<BREAK HARDWARE A> 


@ NOTE: 
@ NOTE: 


ONLY A BREAK SET WITH A BREAK COMMAND CAN BE USED AS A SUPERVISOR CALL 


IF A SUPERVISOR CALL AND A SEPARATE SPECIFIED BREAK EXIST AT THE SAME 
POINT, THE SUPERVISOR CALL WILL NOT BE EXECUTED. 


(1) sreciries EITHER: 
SET HARDWARE BREAK C AS A SUPERVISOR CALL 
Gas SOFTWARE BREAK 7 AS A SUPERVISOR CALL 


Os USER SOFTWARE BREAK AS A SUPERVISOR CALL 


(2) seeciries EITHER, 


0 | Osc: BREAK IF USED AS A SUPERVISOR CALL 


0 | as: BREAK IF NOT USED AS A SUPERVISOR CALL 


@ NOTE: IF No PARAMETER IS SPECIFIED, THE CURRENT SET 
STATE 1S DISPLAYED. 


S THe SUPERVISOR COMMAND 1S USED TO SET ANY GIVEN BREAK POINT AS A 
U SUPERVISOR CALL. 


WHEN EXECUTED, DATA 1S DIRECTLY TRANSFERRED 


(WITHOUT STOPPING AT THE SUPERVISOR BREAKPOINT) BETWEEN THE PROGRAM 
AND THE ICD SERIAL INTERFACE. 
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EXAMPLE @ 


@ NOTE: THE FUNCTION CODE 1S 


STORED IN THE E REGISTER AND 
INPUT/OUTPUT DATA 1S EXECUTED 
IN THE A REGISTER. 


@ See APPENDIX C 


| EXAMPLE | 


SET THE TRACE MODE; 


>T A, 106, 405 


DISPLAY TRACE STATUS; 


>T 
(ON) ALL 


0100-0300 


EXECUTE TRACE EXAMPLE; 


6 100 


PC MC 
0100 210000 
0103 1100B¢ 
0106 D5 
0107 116003 
O10A 7E 


ty 
DIE C36004 
H400 018016 


0405 FO 


OP 
LD HL, QAQOH 
LD eae 


RELEASE THE TRACE MODE; 


>T CLR 


DE 
1561 
BOdd 


SP AF BC 
ooo2 0623 1481 
1300 


6301 


@ NOTE: Trace pIsPLAYS ">" wiTH THE <ESC> KEY TO ACCEPT A COMMAND. 
@ NOTE: Trace 1S EXECUTED BY THE "GO" COMMAND, WHICH STARTS THE DISPLAY, 


lY 


|  IF(SP) 


EXAMPLE -@ 


es9000000@ °s80a 


SPECIFIES THE SINGLE STEP MODE (IN THIS MODE, 
THE ALL or JUMP TRACE 1S EXECUTED EVERY TIME 
THE SPACE BAR OR RETURN KEY 1S PRESSED) 
(2) sreciries EITHER: 

A a MODE; ALL COMMANDS ARE TRACED AND DISPLAYED 


oN" MODE! ONLY BRANCH COMMAND 1S TRACED AND 
DISPLAYED 


© SPECIFIES THE BEGINNING ADDRESS OF THE MEMORY AREA TO § PHY 16 
BE TRACED AND DISPLAYED(DEFAULT 1S 


PAY SPECIFIES THE ENDING ADDRESS OF THE MEMORY AREA TO BE (PHY 16 | 
TRACED AND DISPLAYED (DEFAULT 1S FFFFF) . 


2] (5) maxes THE CURRENT TRACE MODE; 


OO 


| INVALID 
GQ cucareo 


@  wWlE: IF No PARAMETER 1S SPECIFIED, THE CURRENT TRACE MODE 
SET STATE 1S DISPLAYED. 


THE TRACE commMaND 1S USED TO SET THE ICD TRACE MODE. 
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| EXAMPLE | 


USER COMMAND WITH DESIGNATED TERMINATOR, 


>U ! 

>A DIR B: 

B: PIP COM : STAT COM : DUMP COM : LOAD COM 
B: ED COM : ASM COM : SYSGEN COM : MOVCPM COM 


EXAMPLE -@& 


CG) SPECIFIES THE CODE USED AS A TERMINATOR 


@ NOTE: THE FOLLOWING CANNOT BE SPECIFIED AS THE 
TERMINATOR CODES 


AS THE TERMINAL FOR THE HOST ComPuTER SYSTEM. WHEN THIS COMMAND 1S 
EXECUTED, THE ICD SENDS ALL CODES (EXCLUDING TERMINATOR CODES 
RECEIVED FROM THE TERMINAL PORT) TO THE HOST PORT WITHOUT ASSUMING 
THEM TO BE ICD COMMANDS. 


THE USER COMMAND ALLOWS THE CONSOLE TERMINAL TO BE USED TEMPORARILY 
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EXAMPLE 


>[v] Jor: felsfofsfolc 


(i) sreciries EITHER THE} ComPARE THE TEST.HEX FILE ON 
DISKETTE WITH THE MEMORY 
7 EI PORT (IGNORE SOFTWARE HANDSHAKE) CONTENTS: 
| P TERMINAL PorRT (PERFORM SOFTWARE HANDSHAKE ) >V TEST 
ADRS M O 
AUXILIARY port (IGNORE SOFTWARE HANDSHAKE) 0606 
CY vost PORT (PERFORM SOFTWARE HANDSHAKE) 
; ~V/T , 100 
(2) sreciries THE OBJECT NAME TO COMPARE ADRS M O 
2 0200 
(3) sreciries THE BIAS OF THE FILE OR OBJECT TO COMPARE 
(4) sreciries THE VERIFY MESSAGE [sci val 
@ NOTE: THIS PARAMETER 1S VALID ONLY WHEN THE UTILITY NOTE: "Aprs", "M" and "“O" 
SOFTWARE PROGRAM ZICE 1S AVAILABLE. INDICATE THE MEMORY ADDRESS, 
CONTENTS OF THE MEMORY ADDRESS 
2) NOTE: IF OMITTED, THE OBJECT STARTING ADDRESS 1S ASSUMED AND OBJECT, RESPECTIVELY. 


THE VERIFY COMMAND 1S USED TO COMPARE A HOST COMPUTER FILE OR OBJECT 


IN THE INTEL FORMAT, WITH THE CONTENTS OF THE ICD MEMORY. @® See APPENDIX D 
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ERROR MESSAGE COMMAND OCCURRENCE DISPLAYED WHEN: 


GR TIE TIE TTR TT A SE LEE ITE RS EE 


UNABLE BREAK ADDRESS BREAK; GO WHEN A SOFTWARE BREAK IS SPECIFIED 
IN THE NONRAM AREA 


MULT! BREAK ADDRESS BREAK, GO WHEN A SOFTWARE BREAK IS DUPLICATED 
AT THE SAME ADDRESS 


WARNING UNABLE SOFT BREAK BREAK IF A SOFTWARE BREAK IS SET AT THE 
ADDRESS PRESENTLY NOT MAPPED IN RAM 


#** FILE NOT FOUND ALL WHEN NO FILE EXISTS 
##% DISK READ ERROR ALL WHEN DISK READ ERROR OCCURS 
*** CHECK SUM ERROR ALL WHEN SUM CHECK ERROR OCCURS 
###* DISK WRITE ERROR ALL WHEN DISK WRITE ERROR OCCURS 


##* NO DIRECTORY SPACE ALL WHEN NO BLANK AREA 1S AVAILABLE 


ERROR MESSAGE 


C?> 
P?> 


/?> 


MEMORY WRITE ERROR AT XXXX 


MEMORY TIMEOUT ERROR AT 
XXXX 
|/O TIMEOUT ERROR AT XX 


XXXX INPUT ERROR 


BREAK BUSY 


COMMAND OCCURRENCE 


ALL 
ALL 
ALL 


ASSEMBLE, EXAMINE, LOAD 
MOVE, FILL 


ASSEMBLE, DUMP, EXAMINE 
FILL, LOAD, MOVE, 
COMPARE, VERIFY, SAVE 
PORT, SEARCH 


EXAMINE, ASSEMBLE, PORT 


BREAK, GO 


DISPLAYED WHEN: 


WHEN A COMMAND CODE ERROR OCCURS; 
WHEN A PARAMETER CODE ERROR OCCURS; 
WHEN A MODIFIER CODE ERROR OCCURS; 


--- WITH A <BELL> CCONTROL +G), 
WHEN THE INPUT COMMAND STATEMENT 
CONTAINS AN ERROR 


DUE TO MEMORY MODIFICATION ERROR 
(XXXX - |S THE MEMORY ADDRESS AT 
WHICH THE ERROR OCCURS) 


IF MEMORY 1/0 IN THE TARGET SYSTEM 
DOES NOT RESPOND TO ICD ACCESS, 
TIMEOUTS A WAITSTATE 


AS AN INPUT ERROR. RE-ENTER DATA 
AFTER ERROR MESSAGE. 


WHEN THE BREAK SPECIFICATION EXCEEDS 
THE LIMIT 


ERROR’ MESSAGES 


APPENDIX A 


HISTORY Command Supplement 


REAL-TIME TRACE SPECIFICATIONS 


WORD WIDTH 

WORD SIZE 

ACQUISITION CYCLE 
EFFECTIVE TRACE SECTION 


FIXED TRACE DATA 


TRIGGERING 


DISPLAY 


MaxIMuM 32 BITS 

2K WORDS 

CPU MACHINE CYCLE (150 NS MIN.) 
2046 MACHINE CYCLES 

(1.09 ms MIN.:6 MHz) 

AO-A15 


THE START AND END OF TRACING 
COORDINATED WITH THE START AND 
END OF EMULATION CAN BE SPECIFED, 
AS CAN THE EVENT TRIGGERED DELAYS. 


MACHINE CYCLE DISPLAY OR INVERTED 
ASSEMBLY DISPLAY. 


REAL-TIME COUNTER SPECIFICATIONS 


COUNT BIT WIDTH 
COUNT CLOCK 
EFFECTIVE COUNT TIME 


TRIGGER MODES 


32 BITS 
CPU cLock (NUMBER OF STATES) 
716 sec.: 6 MHz 


AN EVENT TRIGGER WITH AN EVENT POINT SPECIFICATION OR A MONITOR 
TRIGGER WITH A BREAKPOINT SPECIFICATION, IS USED TO DESIGNATE THE 
TRACE START AND END POINTS. SIX TRIGGER MODES ARE AVAILABLE WITH 


THE ICD HISTORY commaAND. 
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@ BEGIN MONITOR 


ICD Mon! TOR | GO EMULATION BREAK ICD Moni TOR 
BREAK [©] EXECUTE POINT BREAK 

MAX 2K CYCLE 
BEGIN MONITOR 


TRACING BEGINS AT THE START OF EMULATION (INITIATED BY A GO 
COMMAND) AND THE END OF TRACING 1S AUTOMATICALLY ASSUMED BY THE 
TRACING RANGE. THE TRACING RANGE 1S SPECIFIED BY A DELAY SETTING 
OF UP TO 2K CYCLES AFTER EMULATION HAS BEGUN. 


@ END MONITOR 


ICD Mont TOR | EMULAT ION BREAK ICD Mon! TOR 
BREAK = EXECUTE POINT BREAK 


TRACE SECTION 


END MONITOR 


TRACING BEGINS AT THE START OF EMULATION (INITIATED BY A GO 
COMMAND) AND ENDS WHEN CONTROL IS BACK WITH THE MONITOR ON BREAK. 


NOTE: THE TRACE SECTION IS 2K CYCLES MAXIMUM BEFORE THE 
BREAKPOINT. 


@ BEGIN EVENT 


ICD Moni TOR [co] EMULATION = EVENT BREAK |CD MONITOR 
BREAK EXECUTE POINT POINT BREAK 


MAX 2K CYCLE 


TRACE SECTION 


BEGIN EVENT 

TRACING BEGINS ON PASSING THE EVENT POINT AFTER THE START OF 
EMULATION (INITIATED BY A GO COMMAND) AND ENDS AT THE END OF THE 
TRACING RANGE. THE TRACING RANGE IS SPECIFIED BY A DELAY SETTING 


OF UP TO 2K CYCLES IMMEDIATELY AFTER PASSING THE FIRST EVENT 
POINT. . 


@ CENTER EVENT 


1CD Mont TOR EMULATION EVENT BREAK ICD Mon1TOR 
BREAK EXECUTE POINT PoINT BREAK 


MAX 2K 


CYCLE DELAY 


SECTION 


TRACE 


2K DELAY 


2K CYCLE 


CENTER EVENT 

TRACING BEGINS AT THE START OF EMULATION (INITIATED BY A G@ 
COMMAND). THE TRACE SECTION IS SPECIFIED ON EITHER SIDE OF THE 
EVENT POINT (UP TO 2K MAXIMUM). THE END OF THE TRACE 1S 
DETERMINED BY A DELAY -OF UP TO 2K CYCLES AND THE BEGINNING OF THE 
TRACE 1S SPECIFIED BY A MAXIMUM OF UP TO 2K CYCLES MINUS THE 
DELAY SPECIFICATION. 


@ END EVENT 


ICD Mon TOR EMULAT | ON EvENT BREAK  1CD MONITOR 
BREAK EXECUTE POINT POINT BREAK 


| pee 
Hea cee ial ane ea ol ca 

[Trace section } 

END EVENT 


TRACING BEGINS AT THE START OF EMULATION (INITIATED BY A GO 
COMMAND) AND ENDS AFTER PASSING THE FIRST EVENT POINT. THE TRACE 
SECTION 1S A MAXIMUM OF 2K CYCLES UP TO THE EVENT POINT. 


@ MULTIPLE EVENTS 


ICD Moni Tor EVENT EVENT EVENT BREAK ICD Mon! TorR 
BREAK POINT POINT POINT POINT BREAK 


DELAY DELAY 


MULTIPLE EVENTS 
TRACING 1S PERFORMED EACH TIME AN EVENT 1S PASSED WHERE MULTIPLE 


EVENTS ARE HANDLED AS IN LOOP PROCESSING. THE TRACE SETTING 1S 
SPECIFIED BY A DELAY SETTING OF UP TO 2K CYCLES IMMEDIATELY AFTER 
PASSING THE EVENT POINT. 


APPENDIX B 


IN-CIRCUIT Map/Pin Setting 


7 Command set 
Ler ee le Ne ee 
aE a ORE ee 


11 [parviat inca Mode | RO | RW | Us [NO [EN | DI | 


IN-CIRCUIT COMMAND MAP/PIN SETTING 


(RW) : OPERATES AS RW REGARDLESS 
OF MAP COMMAND SETTING. 


(US) : OPERATES AS US REGARDLESS 
OF MAP COMMAND SETTING. 


(EN) : OPERATES IN EN STATE REGARDLESS 
OF THE PIN COMMAND SETTING. 


(Diy 2 OPERATES IN DI STATE REGARDLESS 
OF THE PIN COMMAND SETTING. 
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FUNCTION CODE KEY 


(1) Function cope 08 or 10: ON CHARACTER INPUT FROM THE PORT. 


(2) 


(3) 


(4) 


INPUT PARAMETERS; 
RecisTeR RecisteR E : Q@ZH SPECIFIES THE TERMINAL Port. 
104 = Specifies THE HOST/AUX PoRT. 


END STATE; 
REGISTER REGISTER A : ENTRY CHARACTERS 


CHARACTERS INPUT FROM THE PORT SPECIFIED WITH AN INPUT PARAMETER 
ARE STORED IN REGISTER A, IF THERE tS NO CHARACTER INPUT FROM 
THE SPECIFIED SUPERVISOR CALL, CONTROL DOES NOT RETURN TO THE 
PROGRAM UNTIL CHARACTER INPUT OCCURS. 


FUNCTION CODE @1 or 11 : PorRT INPUT STATE SIGNAL FETCH. 


INPUT PARAMETER; 
REGISTER REGISTER E : Q1H SPECIFIES THE TERMINAL Port. 
11H = SPECIFIES THE HOST/AUX PorRT. 


END STATES 
REGISTER REGISTER A: QOH THERE !S NO INPUT DATA, 
FFH THERE 1S INPUT DATA 


THIS FUNCTION INFORMS THE SYSTEM IF INPUT DATA FROM THE PORT 
SPECIFIED WITH AN INPUT PARAMETER. 


FUNCTION CODE @2 oR 12 : ONE CHARACTER OUTPUT TO PORT. 


INPUT PARAMETER; 
REGISTER REGISTER E : Q2H SPECIFIES THE TERMINAL Port. 
12H SPECIFIES THE HOST/AUX PORT. 


END STATE$ 
REGISTER REGISTER A : QUTPUT CHARACTERS 


THIS FUNCTION OUTPUTS CHARACTERS STORED IN REGISTER A TO THE PORT 
SPECIFIED WITH AN INPUT PARAMETER. IF OUTPUT OF THE PRECEDING 
DATA 1S NOT COMPLETED AT THE SUPERVISOR CALL, CONTROL DOES NOT 
RETURN TO THE TARGET PROGRAM UNTIL OUTPUT |S COMPLETED. 


FUNCTION CODE 03 oR 13 : PoRT OUTPUT STATE SIGNAL FETCH. 


INPUT PARAMETER; 
REGISTER REGISTER E : @2H SPECIFIES THE TERMINAL Port. 
13H SPECIFIES THE HOST/AUX PoRT. 


END STATE; 
REGISTER REGISTER A: OCH OUTPUT HAS NOT BEEN COMPLETED. 
FFH QUTPUT HAS BEEN COMPLETED. 


THIS FUNCTION INFORMS THE SYSTEM IF DATA FROM THE PORT SPECIFIED 
BY A PARAMETER HAS BEEN COMPLETED. 


APPENDIX C 


SUPERVISOR Function Code Setting 


pUNGT hone | DATA OUT: | /DATACTN 
FUNCTION 


re ee 
fosvaux et awe | te | =n 
Oe 
ROSE ADE Foe sara ty | a 
emanate ate on | 0? owen | 
oer Pes owes | Owen |= 
emanate capa weer es | —~_—([ a ate 
OST AUK eat napa wate ata | ~ [moa wae 


@see FUNCTION CODE KEY 


82 


APPENDIX D 


OBJECT 1/O Procedure 


APPENDIX D DISPLAYS THE OBuECT |/O PROCEDURE FOR THE COMMANDS: 


LOAD SAVE VERIFY 


MODE REMOTE LOCAL 


0 (HOST) x (TERMINAL) 


O : DENOTES SOFTWARE HANDSHAKE |S PEFORMED. FOR THE CORRECT 
COMMUNICATION PROTOCOL, PLEASE REFER TO; 


SOFTWARE SPECIFICATIONS OF HosT COMPUTER SYSTEM 


NOTE: For THE LOAD messacGeE To BE uSED, /T AND /A MUST BE 
SPECIFIED AT THE OBJECT INPUT PORT. 

NOTE: THE OBUECT NAME MAY BE SPECIFIED AS THE USER DEFINITION 
LOAD messace IF /P and /H ARE DESIGNATED DURING SOFTWARE 
HANDSHAKE. 
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